I wouldn't say that the new syntax is more readable. Separating words makes sense, with numbers it just looks off to me. But maybe it's just me, if everyone agrees on this I won't try to change your mind.

I share this opinion.

I'm very much on the fence myself. I'll wait for more comments to drop in this thread and decide based on how many votes style got.

I personally think it's fine to not document a preference for this, leave previous placeholders as it is and decide on a case by case basis (i.e. aligning with upstream docs examples).

Also, my biggest concern is it will increase the character count of the examples making large examples (i.e. some AWS subcommands, etc) with multiple placeholders even larger to display.